home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / sillies / _aquarium / _readme < prev    next >
Text File  |  1990-05-21  |  3KB  |  78 lines
  1.  
  2.  Please read this if you intend hacking around with !Aquarium:
  3.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  4.  
  5.  The first problem you are likely to encounter is that of
  6.  changing/altering the sprites:
  7.  
  8.  DECOMPRESSING THE SPRITES FOR EDITING WITH !Paint:
  9.  ==================================================
  10.    To decompress the sprites for editing in !Paint, edit
  11.  the !RunImage, and look in PROCinitsprites for the point
  12.  where there is a CALL command. After this, place the
  13.  line:
  14.  SYS "OS_SpriteOp",256+12,spr%,"$.!Aquarium.Sprites":END
  15.    Now, run !Aquarium, and (if you have >110kB free on
  16.  your disc) you should have the original sprite file in
  17.  the !Aquarium.Sprites. This file can also beconverted
  18.  back simply by running the 'PackSprite' program. See
  19.  below.
  20.  
  21. RE-COMPRESSING THE SPRITES FOR USE IN !Aquarium:
  22. ================================================
  23.    In the !Aquarium directory, you will find a small BASIC
  24.  program called 'PackSprite'. This attempts to pack the
  25.  sprite file called '$.!Aquarium.Sprites' into a file
  26.  called '$.!Aquarium.PackedSpr'.
  27.  MAKE SURE YOU ONLY RUN THIS USING A BACKUP COPY OF !Aquarium!
  28.    Then, you must alter the !RunImage program: It
  29.  decompresses the sprites in a procedure PROCinitsprite.
  30.  The 2 important things to check here are:
  31.   1) Have I got enough space reserved to hold the
  32.      decompressed sprites?
  33.   2) (look for the line marked with **** in a REM) Have
  34.      I put the correct 'Original Sprite size' value into the
  35.      correct variable?
  36.  You will know when you have got these wrong, 'cos the
  37.  desktop will crash horrendously!
  38.    Now if any errors occur, they are most likely due to
  39.   too small a WimpSlot value. (Especially if you have
  40.   compiled the !RunImage)
  41.  
  42.  
  43.  To compile !Aquarium:
  44.  =====================
  45.    RiscBasic likes the !RunImage, and you only need to
  46.  remove the 'END=END+xxxx' line near the start of the
  47.  program for it to compile happily.
  48.    ABC 2 doesn't like it at all! (I got it to compile,
  49.  but it never ran)
  50.  
  51.  
  52.  Yo! Keep reading!
  53.  =================
  54.    Also, if you make any good improvements to this
  55.  application, have any new ideas for Aquarium-
  56.  based animation or other animations, or write
  57.  your own animation for use with this, PLEASE
  58.  send me a copy to look at!
  59.  (Ideas at present include 'Dolls House', 'Ant Farm',
  60.  and 'Aviary' (Bird cage))
  61.  
  62.  I am at:
  63.  
  64.    J.Williams,
  65.    R.D.2, Manuel Road,
  66.    Silverdale,
  67.    North Auckland,
  68.    NEW ZEALAND.
  69.  
  70.  Thanks!
  71.  Jason Williams, '90.
  72.  
  73.  
  74.  P.S. If anyone is willing to donate a 30MHz ARM-3, I
  75.  would really really really like to write a 30MHz (and
  76.  12MHz) it'll-blow-you-away version!! (hint hint)
  77.                                      
  78.